home *** CD-ROM | disk | FTP | other *** search
/ MacWorld UK 2000 March / MW_UK_2000_03.iso / Shareware World / Utilities / Text Processing / Alpha / Help / Internet Config < prev    next >
Encoding:
Text File  |  1999-07-26  |  20.4 KB  |  468 lines  |  [TEXT/ALFA]
  1.  
  2.                 Internet Config
  3.  
  4. Internet Config is a freeware utility that holds system-wide Internet 
  5. preferences, especially preferences that might be accessed by more than one 
  6. application. For example, Internet Config stores pointers to helpers for 
  7. web services, ftp, etc.
  8.  
  9. Alpha supports "Internet Config" in the following ways:
  10. • Command-clicking on any text causes Alpha to try find a URL anywhere near 
  11. where you click. If Alpha finds one it sends it to Internet Config which 
  12. passes it to the right helper application. Unfortunately, this feature is 
  13. rather buggy. Whenever there is a colon nearby where you click Alpha 
  14. usually thinks there is a URL, although there is not, and sends it to 
  15. Internet Config. This bug prevents command-double-clicking to work 
  16. properly.
  17. • The Internet Config menu allows either Internet Config itself, or several 
  18. of it's internet helpers, to be started.
  19. • Alpha can get the helper application for http and ftp from Internet 
  20. Config. Checking 'Synchronise with Internet Config' in the preferences 
  21. dialog "Config->Preferences->WWW" will make Alpha get the helper for http 
  22. and ftp from Internet Config every time Alpha is launched.
  23.  
  24. Activating the Internet Config menu
  25.  
  26. The Internet Config menu is activated in the dialog
  27. "Config->Preferences->Menus and Features…" Check the checkbox 'Internet
  28. Config Menu' among the global menus.
  29.  
  30. URLs submenu
  31.  
  32. The 'URLs' submenu allows you to store a few commonly used URLs and to 
  33. launch them, regardless of what helper they are directed to. You add a URL 
  34. to the menu by using 'Add' and specifying a name and the URL.
  35.  
  36. Some examples:
  37.  
  38. Alpha's home page                   http://alpha.olm.net/
  39. Alpha's ftp                         ftp://alpha.olm.net/pub/
  40. Ftp requiring userid and password   ftp://userid:passwd@some.site.edu/path/
  41. Mail to someone                     mailto:somebody@somewhere.net
  42.  
  43. View opens a window with a list of all URLs in the menu, so you can see 
  44. how they are defined.
  45. Remove lets you remove a URL from the menu.
  46.  
  47. Main Internet Config menu
  48.  
  49. Pick Url            To pick a URL from the URL submenu.
  50. Go To               Launches Internet Config
  51. Help                Opens this file
  52. Web Browser         Launches the web browser specified as your http helper 
  53.                     in Internet Config
  54. News Client         Launches the news reader specified as your news helper
  55.                     in Internet Config
  56. Mail Client         Launches the mail program specified as your mailto
  57.                     helper in Internet Config
  58. Ftp Client          Launches the ftp client specified as your ftp helper
  59.                     in Internet Config
  60. Gopher Client       Launches the gopher client specified as your gopher 
  61.                     helper in Internet Config
  62. Telnet Client       Launches the telnet client specified as your telnet 
  63.                     helper in Internet Config
  64. Finger              To finger someone using Peter Lewis's 'Finger' program. 
  65.                     Specify who to finger and the result from Finger will 
  66.                     be display in a window in Alpha.
  67. Telnet              To open a telnet connection. This function works with 
  68.                     NSCA Telnet, Better Telnet, and Nifty Telnet.
  69. Resolve Url         Sends the selected text to Internet Config trying to 
  70.                     resolve the selection and send it to the appropriate 
  71.                     helper.
  72. View Html File      Sends the current window to your web browser. (This is 
  73.                     the same function as 'Send File to Browser' in the HTML 
  74.                     menu.)
  75.  
  76. Below is the documentation for using the Internet Config application.
  77.   ------------------------------------------------------------------------
  78.  
  79.             Internet Config User Documentation
  80.  
  81. Created by ic@stairways.com
  82.  
  83. Introduction
  84.  
  85. The Internet Configuration System was designed to make your life easier by
  86. reducing the number of times which you need to enter your Internet
  87. preferences into the various preferences windows of all your Internet
  88. applications.
  89.  
  90. For example, currently you need to enter your email address into many common
  91. Macintosh Internet applications, for example Claris Emailer, NewsWatcher and
  92. Anarchie. The goal of the system was to get each of these applications to
  93. get this information from one common place and to give you a tool to edit
  94. these common preferences.
  95.  
  96. It is important to realise that applications will have to be modified to
  97. take advantage of the Internet Configuration System. It will take some time
  98. for all applications to be revised and until then you will have to enter
  99. your preferences in those applications in the traditional manner.
  100.  
  101. Getting Started
  102.  
  103. System Requirements
  104.  
  105. The Internet Configuration system requires System 7 or later, and Component
  106. Manager.
  107.  
  108. If you've never heard of Component Manager, that's OK. It's installed as
  109. part of System 7.1 and above, and as part of QuickTime. So chances are that
  110. it's already on your computer. You can just run IC and it will tell you if
  111. you don't have it installed.
  112.  
  113. If you do not have System 7 or Component Manager installed, you can not use
  114. this version of IC. IC 1.4 and below do not have these requirement. You can
  115. FTP old versions of IC from the IC home site.
  116.  
  117. IC does not require MacTCP or Open Transport, and it makes sense to install
  118. it even if you're not directly connected to the Internet.
  119.  
  120. Quick Start
  121.  
  122. Run the Internet Config application. If it asks you whether you want to
  123. install the Internet Config Extension, say that you do. Click on each button
  124. in the Main window in turn, enter appropriate preferences. [If you don't
  125. understand an item, turn on Balloon Help or look it up in the reference
  126. section at the end of this document.] Save and quit.
  127.  
  128. It is important to realise that you don't have to set every preference. For
  129. example, if you don't use WAIS, there's no need to set your WAIS Gateway
  130. preference. The preferences that you most probably want to set (grouped by
  131. window) are:
  132.  
  133.    * Personal
  134.         o Real Name, eg "Santa Claus"
  135.         o Organisation, eg "Happy Holidays, Inc"
  136.         o Signature, to be appended to email and news messages that you
  137.           send.
  138.    * Email
  139.         o Email Address, eg "santa@north-pole.org"
  140.         o Email Account, , eg "santa@pop.north-pole.org"
  141.         o Email Password, the password for the above account
  142.         o SMTP Host, eg "mail.north-pole.org"
  143.    * News
  144.         o NNTP Host, eg "nntp.north-pole.org"
  145.    * WWW
  146.         o Home Page, eg "http://www.north-pole.org/MyHomePage.html"
  147.         o Search Page, eg "www.alta-vista.digital.com"
  148.    * File Transfer
  149.         o Download Folder
  150.    * Helpers
  151.         o Set the "http", "https", and "file" helper to your preferred web
  152.           browser.
  153.         o Set the "ftp" helper to your preferred FTP client.
  154.         o Set the "mailto" helper to your preferred email application.
  155.  
  156. Parts of the System
  157.  
  158. The system contains 3 important parts:
  159.  
  160.    * Internet Config application
  161.    * Internet Config Extension
  162.    * the Internet Preferences preferences file
  163.  
  164. The most important is the Internet Config application. When you run this
  165. application it creates and installs the Internet Config Extension (in the
  166. Extensions folder) and creates a default Internet Preferences file (in the
  167. Preferences folder).
  168.  
  169. For programmers there is a separate distribution that contains all the files
  170. needed to make an Internet Config aware program.
  171.  
  172. Internet Configuration Application Reference
  173.  
  174. The Internet Configuration application works much like any other Macintosh
  175. application. The basic document for the application is an Internet
  176. Preferences preference file.
  177.  
  178. Unlike most Macintosh applications, when you launch the Internet
  179. Configuration application it does not create a new untitled document.
  180. Instead it opens the Internet Preferences file in your Preferences folder
  181. (creating it if it isn't there). This is useful because, unless you're doing
  182. something strange, you need never use the standard document features (New,
  183. Open, Save, etc). Instead all you need to do is launch the application,
  184. modify your preferences and then quit with saving.
  185.  
  186. Menus
  187.  
  188. The following commands are available on the Apple menu:
  189.  
  190. About Internet Config
  191.  
  192. This opens the about box. Do not bother looking for magical Easter Eggs; we
  193. were much too busy to mess with that sort of thing. You can, however, click
  194. on the blue underlined text to view the latest IC FAQ or mail the Internet
  195. Config support address.
  196.  
  197. The following commands are available on the File menu:
  198.  
  199.    * New
  200.    * Open
  201.    * Open Internet Preferences
  202.    * Close
  203.    * Save
  204.    * Save as
  205.    * Quit
  206.  
  207. These commands work as you would expect in a normal Macintosh application,
  208. with one exception. The application can only have one preferences file open
  209. at any point in time, so when you open a new preferences file, by Open or
  210. New , the previous one is automatically closed. The Open Internet
  211. Preferences command opens the default set of Internet Preferences (in your
  212. Preferences folder), which is useful if you accidentally close the window.
  213.  
  214. The Edit menu is used for editing text.
  215.  
  216. The Sets menu allows you to create multiple independent sets of preferences
  217. for different users of the computer, or different Internet personalities of
  218. the same user. The Sets menu contains the following commands:
  219.  
  220.    * Duplicate
  221.    * Rename
  222.    * Delete
  223.  
  224. The Duplicate command allows you to create a new set by duplicating the
  225. current set. The Rename command allows you to give a new name to the current
  226. set. The Delete command lets you delete the current set. The remaining items
  227. on the Sets menu allow you to switch between sets.
  228.  
  229. The Extension menu lets you install the Internet Config Extension in your
  230. Extensions folder. As IC does this when you first launch it, there is rarely
  231. any point to this. It also allows you to save a copy of the extension
  232. without installing it.
  233.  
  234. The Window menu allows you to open or bring to front any of the
  235. configuration windows.
  236.  
  237. The Help menu (under Mac OS 7.6.1 and earlier, this is on the right side of
  238. the menu bar with a question mark icon) lets you turn on Balloon Help. The
  239. application has full Balloon Help support.
  240.  
  241. Windows
  242.  
  243. The Main window is opened whenever you open a preferences file. It has 10
  244. buttons (with cutesy colour icons) that let you open the other windows.
  245.  
  246. The Personal window lets you edit all sorts of preferences related to your
  247. person. These include:
  248.  
  249.    * Real Name -- your real name, as used by news and mail
  250.    * Organisation -- the company etc that you work for, as used by news
  251.    * Quote String -- the string used to precede quoted text, as used by news
  252.      and mail
  253.    * Signature -- a short piece of pithy text added to the end of your mail
  254.      messages and news posting, as used by news and mail
  255.    * Plan -- as used by finger servers
  256.  
  257. The Email window lets you edit preferences related to email. These include:
  258.  
  259.    * Email Address -- address to which you want replies to your mail sent
  260.    * Mail Account -- account from which you wish your mail to be fetched
  261.    * Mail Password -- password for the above
  262.    * Mail Host -- host to which to forward mail (normally the same machine
  263.      as the one that has your mail account)
  264.    * Mail Headers -- any extra headers you want inserted in your outgoing
  265.      mail
  266.    * On New Mail -- a group of preferences that specify what happens when
  267.      new mail arrives
  268.  
  269. The News window lets you edit preferences related to News. These include:
  270.  
  271.    * News Username -- most systems let you read news without one
  272.    * News Password -- most systems let you read news without one
  273.    * NNTP Host -- machine from which to fetch news
  274.    * News Headers -- any extra headers you want inserted in your news
  275.      postings
  276.  
  277. The World Wide Web window lets you edit preferences related to the World
  278. Wide Web. These include:
  279.  
  280.    * WWW Home Page -- a URL for the page you want your web browser to open
  281.      first
  282.    * WWW Search Page -- a URL for the page you want your web browser to use
  283.      as its search page
  284.    * Colour -- various options to configure the default colours for your web
  285.      pages
  286.  
  287. The File Transfer window lets you edit preferences related to the transfer
  288. of files (except file types, which have their own window). These include:
  289.  
  290.    * Archie Server -- your preferred Archie server
  291.    * Info-Mac Server -- your preferred Info-Mac mirror
  292.    * UMich Server -- your preferred UMich mirror
  293.    * Download Folder -- the place where you want new files to appear
  294.  
  295. Archie is a protocol for searching archive sites looking for files. There
  296. are a number of Archie servers around the world. In theory these should all
  297. be the same but sometimes it's useful to use one in preference to another.
  298.  
  299. Info-Mac and UMich are two big archives of Macintosh software. They are
  300. often very busy and won't let you on. To get around this you can get files
  301. from other machines that mirror these archives. Some software will use the
  302. preferences here to automatically route requests to your preferred mirror.
  303.  
  304. The Other Services window is a collection of preferences that didn't fit in
  305. anywhere else. These include:
  306.  
  307.    * Ph Host -- your preferred Ph server (a standard machine name)
  308.    * Finger Host -- your default finger server
  309.    * Whois Host -- your default whois server
  310.    * Telnet Host -- the default machine for telnet connections
  311.    * FTP Host -- the default machine for FTP connections
  312.    * Gopher Host -- your 'root' gopher server (a standard machine name)
  313.    * WAIS Gateway -- your WAIS gateway (a standard machine name)
  314.    * LDAP -- Stuff related to X.500, see your X.500 docs for more details
  315.  
  316. The Fonts window lets you set your preferred List, Screen and Printer font.
  317. The List font is used in summary listings, such as mailbox summaries or FTP
  318. directory listings. The Screen font is used to display monospaced text, such
  319. as the body of mail or news messages. The Printer font is used to print
  320. monospaced text.
  321.  
  322. The File Mappings window lets you view and edit the table that is used to
  323. set the Macintosh file type and creator of incoming files based on their
  324. extension. If you don't understand this window then please don't worry.
  325. We've done our best to set up appropriate defaults. If you have any problems
  326. with file transfers, then resetting to factory defaults will probably help.
  327.  
  328. The Helpers window lets you view and edit the table that is used to
  329. determine which application to run when a specific URL is accessed. For
  330. example, ICeTEe uses this table to determine what application to run when
  331. you command click a URL.
  332.  
  333. The Firewalls window lets you configure firewall information. Most
  334. commercial organisations on the Internet have firewalls that prevent
  335. unauthorised access to the organisation's network from outside. Sometimes
  336. these firewalls require you to specially configure your Internet
  337. applications. Internet Config maintains a central copy of this special
  338. configuration for all applications to use.
  339.  
  340. Credits
  341.  
  342. If you find a bug in Internet Config then please forward details to the
  343. official support address for Internet Config. Please read the Internet
  344. Config FAQ before sending messages to this address. If you want to discuss
  345. Internet Config in general then we suggest you host that discussion on the
  346. comp.sys.mac.comm newsgroup.
  347.  
  348. The Internet Configuration System was written by Quinn "The Eskimo" and
  349. Peter N Lewis over a period of way too many late nights and weekends.
  350. Certain important chunks of code were contributed by Marcus Jager and Stuart
  351. Cheshire. Craig Richmond provided a lot of help sorting out the default MIME
  352. mappings. Much of the extension to type mapping information was gleaned from
  353. Robin D H Walker's Extension-to-Type mappings file. Eric Kidd maintains the
  354. Internet Config web site and also gave invaluable insight into the problems
  355. of override components. John Norstad graciously contributed the resource
  356. fork sanity checking code from his legendary Disinfectant anti-virus
  357. utility.
  358.  
  359. We would like to thank all of those on the Internet Config mailing list and
  360. all of the developers who have adopted the system.
  361.  
  362. The entire Internet Config system is public domain and can be redistributed
  363. without restriction.
  364.  
  365. The latest version of Internet Config can be FTPed from the home sites in
  366. Australia and the USA.
  367.  
  368. Release Notes
  369.  
  370. This section contains information about the various released versions of
  371. Internet Config, in reverse order:
  372.  
  373. IC 2.0 (Feb 1998)
  374.  
  375.    * Internet Config now requires System 7.0 or later, and Component
  376.      Manager.
  377.    * The system now supports multiple separate preferences sets. Multiple
  378.      users can now share the same machine with consummate ease. Existing
  379.      preference files are automatically converted to a new file with a
  380.      single set, "My Settings".
  381.    * User kit now includes a Control Strip module and Location Manager
  382.      module for quickly switching between preference sets.
  383.    * Fixed cosmetic programs under Mac OS 8.0 and later.
  384.    * Added APIs to allow external file systems to access the IC extension
  385.      mapping database.
  386.    * Reworked the programming environment. See the Programming Kit for
  387.      details.
  388.    * Bug fixes and new preference defaults.
  389.  
  390. IC 1.4 (Mar 1997)
  391.  
  392.    * The IC application now supports GURL AppleEvents, routing them to the
  393.      appropriate helper application. This eliminates the need for an IC
  394.      scripting addition for this trivial task.
  395.    * If you do not have a specific helper set for "https" and "file" URLs,
  396.      IC will now map them to the "http" helper.
  397.    * The extension now holds the default preferences, so you get default
  398.      preferences regardless of which application first uses IC.
  399.    * The extension now sanity checks preference files before opening them.
  400.      It also keeps a copy of the most recent preferences in the data fork of
  401.      the preference file, so it can revert to that backup. If that fails, it
  402.      reverts to default preferences.
  403.    * You can now copy the IC FAQ URL out of the about box. This feature lets
  404.      me answer IC support mail quicker.
  405.    * Removed "Internet Config RandomSignature" from the distribution --
  406.      while the old version should still work, I don't have time to update
  407.      and test it for this release.
  408.    * Removed "Eudora GURL Handler" from the distribution. The latest version
  409.      of Eudora has support for GURL AppleEvents.
  410.    * Updated and extended the File Mappings database.
  411.    * Pasting into password text fields now works.
  412.    * Fixed a memory leak in the extension when you open a URL with the
  413.      helper application not already running.
  414.    * Fixed a tiny memory leak in the extension when you delete a preference.
  415.    * Fixed a bunch of other minor bugs in the application that I found while
  416.      doing a code review. As far as I know, no one has encountered these
  417.      problems but me.
  418.    * Did extensive work on the internals of the extension and the
  419.      application, cleaning up and commenting the code in preparation for
  420.      large functional changes in the future. Removed Think Pascal from the
  421.      build system.
  422.    * IC 1.3 broke System 6 support but IC 1.4 again supports it.
  423.  
  424. IC 1.3 (Aug 1996)
  425.  
  426.    * Fixed a bug where the File Transfer would crash if the preference file
  427.      wasn't originally created by the Internet Config application.
  428.    * Added the Firewalls window. These preferences are used by Cyberdog and
  429.      Fetch, and will hopefully be adopted by many other applications.
  430.    * Added the World Wide Web window. Although it has very few preferences
  431.      at the moment, I expect that to change soon.
  432.    * Added mail notification preferences to the Email window.
  433.    * Improved the error display code.
  434.    * Improved the URL parsing code. IC (and any application that uses it to
  435.      parse URLs) will now recognise URLs surrounded by parentheses, square
  436.      brackets, and quotes.
  437.  
  438. IC 1.2 (Dec 1995)
  439.  
  440.  
  441.    * Added the sort and default buttons in the File Mappings window.
  442.    * Made the about box hot.
  443.    * Switched the documentation to HTML format.
  444.    * Added a bunch of new API routines to support Cyberdog, and any other
  445.      application that wants to act like the Internet Config application.
  446.    * Added the ICFindPrefHandle routine, which supplants ICGetPrefHandle and
  447.      provides better semantics.
  448.  
  449. IC 1.1 (May 1995)
  450.  
  451.    * This version was released to correct a number of minor problems with
  452.      1.0, including the System 6 support and the popup menu CDEF crashing
  453.      with lots of fonts installed.
  454.    * Added the List Font preference.
  455.    * Shipped with ICeTEe and Internet Config RandomSignature in the Goodies
  456.      folder.
  457.    * Added API routines to support parsing and launching URLs.
  458.    * Added API routines to support the file type mapping preference.
  459.  
  460. IC 1.0 (Dec 1994)
  461.  
  462.    * The first released version.
  463.  
  464.   ------------------------------------------------------------------------
  465. This document is Public Domain (really, we mean it!). No Rights Reserved
  466.  
  467. Comments: ic@stairways.com
  468.